home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr22 / fraani23.zip / FRACTANI.DOC < prev    next >
Text File  |  1995-03-30  |  20KB  |  488 lines
  1.  
  2.      ════════════════════════════════════════════════════════════════════════
  3.  
  4.     ▄████████▄                                      ▄█▄
  5.     ███▀▀▀▀▀▀                            ▄█        ██▀██                   ██
  6.    ███                                 ▄▄██▄▄     ██  ▀█▄                 ▄▄
  7.    ███████  ██ ▄██▄   ▄▄▄   ▄    ▄▄▄     ██      ██    ██      ██ ▄██▄    ██
  8.   ███      ███▀▀  ▀ ██▀▀▀█▄██  ██▀▀▀█▄  ██      ██▄▄▄▄▄███    ███▀▀  ▀█▄ ██
  9.   ███      ██      ██      █▀ ██        ██     ██       ██    ██     ▄█▀ ██
  10.  ███      ██        █▄▄▄▄███   █▄▄▄▄▄  ██    ▄██        ▀██  ██     ▄█▀ ██
  11.  ▀▀▀      ▀▀         ▀▀▀  ▀▀    ▀▀▀▀   ▀▀    ▀▀           ▀▀ ▀▀     ▀▀  ▀▀
  12. ═════════════════════════════════════════════════════════════════════════
  13.  
  14.                                      ▄███▄    █▀▀▀▀▀█
  15.                       ██      ██    █▀   ▀█       ▄▀
  16.                        ██    ██         ▄█▀     ▀▀▄▄
  17.                         ██  ██        ▄█▀           █
  18.                          ▀██▀       ▄██▄▄▄▄ ▄ ▀▄▄▄▄▀
  19.  
  20.  
  21.     FRACTANI is a program to calculate animated fractals with FRACTINT. It
  22.     was developed for the FRACTINT version 18.2 but I think it works
  23.     with older versions of FRACTINT down to version 16.x. I also changed
  24.     the floatingpoint accuracity down to 12 positions after the point
  25.     for a compability with the latest 19.0 version of FRACTINT.
  26.  
  27.     FRACTANI creates a FRACTINT-PAR-file which contains the parameters
  28.     for all frames of the fractal animation and a batch-file which
  29.     calculates all frames with FRACTINT automaticly. The fractals
  30.     calculated by FRACTINT are saved in GIF-format and you can put them
  31.     together to an animation (.FLI or .FLC) with the help of Autodesk
  32.     Animator Pro's POCO-routine 'NUMPIC' or with Dave's Targa Animator
  33.     (DTA).
  34.  
  35.     This FRACTINT parameters are changed by FractAni
  36.  
  37.          corners : which enables the zooming and the rotation of the
  38.                    fractal.
  39.  
  40.          maxiter : to enable high magnifications
  41.  
  42.          bailout,
  43.          params  : to morph the fractal during a flyin
  44.  
  45.          colors  : to cycle the color map in any desired speed
  46.  
  47.     The other FRACTINT parameters are not changed by FractAni, but you
  48.     can use them as static parameters.
  49.  
  50.     You are allowed to distribute FractAni on BBSs and computer networks,
  51.     if you don't change the files in the archiv. The author is not
  52.     reponsible for damages caused by his programs.
  53.  
  54.                                ─────── ∙ ───────
  55.  
  56.  
  57.  
  58.                          New Features since Version 2.0
  59.                          ──────────────────────────────
  60.  
  61.     - added a color cycling feature (see ANINEU.PAR).
  62.  
  63.     - added parameter and bailout morphing (see DANCE.PAR and
  64.       SALAD.PAR).
  65.  
  66.     - the animation velocity can now be changed during the animation.
  67.       (see ANINEU.PAR).
  68.  
  69.     - added smooth in and smooth out for first and the last keyframe, or
  70.       for any other keyframe (see ANINEU.PAR).
  71.  
  72.  
  73.                                ─────── ∙ ───────
  74.  
  75.  
  76.  
  77.                                  List of files
  78.                                  ─────────────
  79.  
  80.    - FRACTANI.EXE       The program
  81.    - FRACTANI.LNG       The laguage file
  82.    - GERMAN  .LNG       The German language file
  83.    - ENGLISH .DOC       This file
  84.    - FRACTANI.REG       The order form for the registrated version of
  85.                         FractAni
  86.    - GERMAN  .DOC       The German documentation
  87.    - ANIMA   .MAP       My favourite color-map (if you like yellow, in
  88.                         fact it's a rotated version of CHROMA.MAP)
  89.    - ANINEU  .PAR       A parameter file witch shows the new features
  90.    - DANCE   .PAR       color cycling and parameter morph demo
  91.  
  92.                                ─────── ∙ ───────
  93.  
  94.  
  95.  
  96.                                   Installation
  97.                                   ────────────
  98.  
  99.    - Copy all files in your FRACTINT-directory. You can create a
  100.      seperate directory for FRACTANI but it's easier this way.
  101.  
  102.    - Kopieren Sie GERMAN.LNG auf FRACTANI.LNG wenn Sie Deutsch benutzen
  103.      wollen.
  104.  
  105.      Don't worry if you can't understand this sentence!
  106.  
  107.    - Copy ENGLISH.LNG to FRACTANI.LNG if you want to use the English
  108.      language.
  109.  
  110.                                ─────── ∙ ───────
  111.  
  112.  
  113.  
  114.                       The Creation of a Fractal Animation
  115.                       ───────────────────────────────────
  116.  
  117.    To create your first fractal animation, just do the following steps.
  118.  
  119.                                      FRACTINT
  120.                                      ────────
  121.  
  122.    1.  Run FRACTINT.
  123.  
  124.    2.  Choose a fractal type by pressing <T>.
  125.  
  126.    3.  Choose a video mode by pressing <Del> or by pressing the right
  127.        function key eg. F3 for 320x200x256 of SF6 for 640x480x256.
  128.  
  129.    4.  Look for the frame (fractal picture) where you want to start your
  130.        animation. Load another color-map if you want to (<E> <ENTER>
  131.        <L>).
  132.  
  133.    5.  Press <B> to save the fractal parameters of the first frame. If
  134.        the input form for the fractal parameter file doesn't appear,
  135.        your FRACTINT version is too old. Look for the newest version in
  136.        COPUSERVE, INTERNET or any other local mailbox.
  137.  
  138.    6.  Enter the name of a parameter file you have not used before. DON'T
  139.        press <ENTER> now, press <cursor down>.
  140.  
  141.    7.  Enter the name of the first frame (parameter record). Don't use
  142.        a name you have used before in this PAR-file because it would be
  143.        overwritten. Remember, FRACTINT sorts the parameter records in
  144.        alphabetical order but stores them in the order you entered them.
  145.        FractAni doesn't look at the name of the records it only loads
  146.        them as they are in the .PAR file.
  147.  
  148.    8.  Press <cursor down> to enter the FRACTANI animation commands in
  149.        the comment line. Enter "#FA " to tell FractAni to interpret the
  150.        following characters of this line as animation commands.
  151.  
  152.        This animation commands are now available:
  153.  
  154.        V(x)           set the animation velocity to x  (see 22.).
  155.  
  156.        S(x)           insert this frame x times in your animation.
  157.                       This will cause a smooth decceleraion and
  158.                       acceleration at this frame after smoothing.
  159.                       You can use that feature e.g to make a ping pong
  160.                       like effect (see Tips).
  161.  
  162.        R(x)           rotate the color palette x times to the right if
  163.                       positive to the left if negative. Default is 0.
  164.                       This means if entered R(0) or nothing in the last
  165.                       key frame, FractAni will rotate the palette x
  166.                       times from the last frame to the current.
  167.  
  168.        This animation commands are only valid for the first key frame
  169.        (parameter record).
  170.  
  171.        E(x)           set the smoothing enviroment to x (see 23.).
  172.  
  173.        F(x)           set the smoothing factor to x (see 24.).
  174.  
  175.    9.  You can press <ENTER> now.
  176.  
  177.    10. Look for the next interesting fractal site where you want to zoom
  178.        in or zoom out, rotating is allowed but no streching and skewing
  179.        (in this version of FRACTANI).
  180.  
  181.    11. Press <B> again and continue at 7. as often as you want.
  182.  
  183.    12. Quit FRACTINT by pressing <Esc>, <Esc>, <Y>.
  184.  
  185.  
  186.                             FRACTANI - Input fields
  187.                             ─────────────────────────
  188.  
  189.    13. Run FRACTANI.
  190.  
  191.    14. Enter the name of the PAR file you entered at 6. Don't forget the
  192.        extension. If FRACTANI had found the PAR-file, a message will be
  193.        displayed in the output window. Otherwise the message 'Parameter
  194.        file not found' will be displayed. In this case , try again and
  195.        enter the right name.
  196.  
  197.    15. Enter the name of the batch-file with the extension. You have to
  198.        run this file to render the animation. This file should be in the
  199.        FRACTINT-directory.
  200.  
  201.        *** With the unregistered version of FRACTANI only ***
  202.        ***            50 frames can be rendered           ***
  203.  
  204.    16. Enter the name of the PAR-file with extension which contains the
  205.        parameter of rendered frames. This file also should be in your
  206.        FRACTINT-directory. Don't use the filename of the PAR-file you
  207.        created with FRACTINT (6, 13) because it would be overwritten.
  208.  
  209.    17. Enter the first three characters of the fractal pictures. If you
  210.        enter 'ANI' for example the GIF-files will be named ANI00000.GIF,
  211.        ANI00001.GIF ... Attention!!! if this files already exists they
  212.        will be overwritten.
  213.  
  214.    18. Enter the DOS-Path of the directory you want to store the fractal
  215.        pictures.
  216.  
  217.    19. Usually the fractal type is read out of the PAR-file, you
  218.        shouldn't change it.
  219.  
  220.    20. Enter the FRACTINT videomode key (eg. F3 for 320x200x256). For
  221.        help of the available videomodes press <F1>. If you want to use
  222.        another videomode which is not specified by a key you have to
  223.        redefine the key to another videomode within FRACTINT. How to do
  224.        this is described at the end of this documentation.
  225.  
  226.    21. If you haven't defined a color-map within FRACTINT you can do
  227.        this now. Enter a '@' in the first position of this line followed
  228.        by the file name (eg. @CHROMA.MAP) if you want to use a colormap
  229.        file. Otherwise you can enter or change the colormap directly
  230.        with the FRACTINT colormap format described at the end of this
  231.        file.
  232.  
  233.    22. The animation velocity describes how fast the animation runs if
  234.        you assume a constant screen frequency. It is specified in
  235.        percent. 10% for example means that the fractal is magnified by
  236.        10% per frame if you zoom directly into the fractal or that the
  237.        fractal is shifted by 10% of the screenwidth if you move the
  238.        'camera' parallel to the fractal. If you want to render a short
  239.        preview of the animation 10% is a reasonable value. To make your
  240.        animation smooth instead of jerky use lower values eg. 2.5%.
  241.  
  242.    23. The smoothing is a very special feature of FRACTANI. It makes
  243.        changes of direction in the animation smooth. It also causes a
  244.        smooth in and smooth out acceleration at the beginning and at the
  245.        end of the animation. You have to experiment with the smoothing
  246.        enviroment and with the smoothing factor to create the right
  247.        smoothing effect. But its simply like this: 'greater values make
  248.        smoother animations'.
  249.  
  250.        The smoothing enviroment defines about how many frames a change
  251.        of direction or what else take place. If you have an animation
  252.        velocity of 10% and an enviroment of 30% for example the change
  253.        of direction will take place over the 3 (=30/10) preceding and the
  254.        3 following frames of the actual current frame. That means that
  255.        the change of direction needs 2*3 + 1 = 7 frames. To save DOS
  256.        memory FractAni deletes the calculated frames after smoothing.
  257.        That means, that you can use only 201 frames for the smoothing
  258.        enviroment. This causes a limitation of the smoothing enviroment
  259.        to hundered times of the animation velocity. If your velocity is
  260.        1.0% e.g. the enviroment is limited to 100.0.
  261.  
  262.    24. The smoothig factor defines how intese farer frames will
  263.        interfere with the actual current frame. If you choose a high
  264.        value 10.0 and more farer frames will interfere like nearer
  265.        frames. Lower values like 1.0 lets further frames interfere with
  266.        the current much lesser. 3.0 is a resonable value for the
  267.        beginning.
  268.  
  269.    25. For many fractal types additional parameters are absolutly
  270.        neccesary. FRACTANI reads automaticly all additional parameters
  271.        out of the parameter-file created by FRACTINT but you can change
  272.        them wihtin FRACTANI. The additional parameters will not be
  273.        changed during the animaton with this version of FRACTANI... One
  274.        important thing you have to know: the first parameter must be
  275.        'reset'.
  276.  
  277.  
  278.  
  279.  
  280.  
  281.                                  FRACTANI - Menu
  282.                                  ───────────────
  283.  
  284.    26. To enter the Menu enter [ENTER] (enter, enter?!), [Esc] or [Crsr
  285.        Dn] in the last input field. To calculate the frames just type
  286.        [ENTER]. The numbers of frames calculated will appear in the
  287.        output window. If you want to change the numbers of frames you
  288.        have to change the animation velocity. Now the menu items
  289.        'SMOOTH' and 'SAVE' will be available.
  290.  
  291.    27. After calculating the frames you can smooth your 'way' through
  292.        the fractal. You can also override this by pressing [Crsr left].
  293.  
  294.    28. To save the animation (the .PAR and the .BAT file) press [ENTER]
  295.        above the menu item 'SAVE'.
  296.  
  297.    29. 'INFO' just shows a little information about the programmer,
  298.        support and the registration.
  299.  
  300.    30. With 'QUIT' you ... FRACTANI. You can ... FRACTANI also by
  301.        pressing [Alt]+[X].
  302.  
  303.                                Back to FRACTINT
  304.                                ────────────────
  305.  
  306.    31. Change to the FRACTINT-directory, if you are not already in this
  307.        directory.
  308.  
  309.    32. By executing the BATCH-file you entered at 15., FRACTINT renders
  310.        the animation to GIF-files. You can now drink a tea, smoke a
  311.        cigarette (european version only) and look how your computer does
  312.        the work for you.
  313.  
  314.  
  315.                               Autodesk Animator Pro
  316.                               ─────────────────────
  317.  
  318.    33. Start Autodesk Animator Pro
  319.  
  320.    34. Choose menu item 'NUMPIC' in menu 'POCO'
  321.  
  322.    35. Click on '2 LOAD PICS AS FLIC'
  323.  
  324.    36. Change to the directory of your GIF-files and click on the
  325.        GIF-file ending with '00000.GIF'.
  326.  
  327.    37. Click on 'REPLACE' and wait ...
  328.  
  329.                                ─────── ∙ ───────
  330.  
  331.  
  332.                            Dave's TARGA Animator (DTA)
  333.                            ───────────────────────────
  334.  
  335.  
  336.    33. Using Dave's .TGA Animator you can convert the GIF-files into a
  337.        FLI. Simply type
  338.  
  339.        DTA filenames /Ofliname /C##
  340.  
  341.        at the DOS-prompt. Where filenames is the name of the GIF files
  342.        with wildcards, e.g. ANI*.GIF. Fliname is the output filename of
  343.        the FLI. The /C switch tells DTA to use the color palette of the
  344.        first GIF for the next ## GIFs. This option just saves a little
  345.        time because DTA haven't to rebuild the color palette. A example:
  346.  
  347.        DTA ANI*.GIF /OANIMA /C46
  348.  
  349.                                ─────── ∙ ───────
  350.  
  351.  
  352.  
  353.                              FRACTANI - Online help
  354.                              ───────────────────────
  355.  
  356.  
  357.    FRACTANI contains a little online help which appears whes you press
  358.    F1. If you are in an input field for filenames the F1 key lists the
  359.    contents of the directory you have entered, otherwise you get
  360.    information about the input field e.g. the available FRACTINT
  361.    videomode keys. You can edit the help text by editing FRACTANI.LNG
  362.    with your favourite text editor.
  363.  
  364.  
  365.                                ─────── ∙ ───────
  366.  
  367.  
  368.                         The FRACTINT color palette format
  369.                         ─────────────────────────────────
  370.  
  371.  
  372.    FRACTINT v18.2 doesn't contain the description of this format, maybe
  373.    I haven't found it, I added a little description of this format.
  374.  
  375.    One R-, G-, B-value is in the range from 0 to 64. FRACTINT uses
  376.    therefore 64 characters
  377.  
  378.    0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ_`abcdefghijklmnopqrstuvwxyz
  379.  
  380.    where '0' means 0 and 'z' means 63. Three values defines one colour.
  381.    The colour black RGB(0,0,0) is represented by '000' and white
  382.    RGB(63,63,63) by 'zzz'. Continous colour palettes are described with
  383.    <###> where ### means the number of continous colours. A continous
  384.    grey palette from white to black which uses all 256 colours e.g. is
  385.    described by zzz<254>000.
  386.  
  387.  
  388.                                ─────── ∙ ───────
  389.  
  390.  
  391.                        Redefine a FRACTINT videomode-key
  392.                        ─────────────────────────────────
  393.  
  394.    If you want to use a TARGA display, you have the problem that
  395.    FRACTINT haven't defined a key for this special video mode. But you
  396.    can redefine a existing key to another videomode within FRACTINT by
  397.    doing the folowing steps:
  398.  
  399.    - Start FRACTINT and press <Del> to enter the videomode selection
  400.      menu.
  401.  
  402.    - Select with the bar the videomode which you want to use in future,
  403.      don't press [ENTER].
  404.  
  405.    - Press the [+] key on your number pad
  406.  
  407.    - Press the key combination you want to use in future for this
  408.      videomode. [Ctrl][F6] (=CF6) for example. CF6 is the former
  409.      Herculesmode (720x348x2).
  410.  
  411.  
  412.                                ─────── ∙ ───────
  413.  
  414.  
  415.                      How to use non-standart VGA resolutions
  416.                      ───────────────────────────────────────
  417.  
  418.    Do want to render an animation with a different resolution like the
  419.    VGA screen you have to define the viewport in FRACTINT.
  420.  
  421.    Type <v> in FRACTINT and set preview to 'yes'. Enter the your image
  422.    resolution in last two lines. The additional parameters in FractAni
  423.    should now contain the static parameter 'viewwindows=4.2/0.75/...'.
  424.  
  425.    Tip: You can use this feature to make a quick preview or to use video
  426.    resolution.
  427.  
  428.                                ─────── ∙ ───────
  429.  
  430.  
  431.                             The language files (*.LNG)
  432.                             ──────────────────────────
  433.  
  434.    You can edit nearly all helptexts, menus and prompts in FRACTANI. Just
  435.    edit FRACTANI.LNG with your favourite text editor. Don't forget to
  436.    regard the adwises at the beginning of FRACTANI.LNG.
  437.  
  438.  
  439.                              Other software poducts
  440.                              ──────────────────────
  441.  
  442.  
  443.    To play  FLI animations you can use many public domain software like
  444.    AAPLAY for Windows and DOS. There is also the possibilty to play the
  445.    animations within YOUR software product with the help of the
  446.    AAPLAY.DLL.
  447.  
  448.                                ─────── ∙ ───────
  449.           
  450.  
  451.                                    Credits
  452.                                    ───────
  453.  
  454.    Thanks to ...
  455.  
  456.    the beta testers : Joerg Bergemann and Roland Schmutzler
  457.  
  458.  
  459.  
  460.                     Conact for problems, ideas,  registration
  461.                     ─────────────────────────────────────────
  462.  
  463.    Kai Mysliwiec                                 Jörg Bergemann
  464.    Siegfriedstr. 18                              c/o media tools
  465.    80803 München                                 Barthstr. 24
  466.                                                  80339 München
  467.  
  468.    Tel: +89-34 54 12                             Tel: +89-502 49 50
  469.                                                  Fax: +89-502 53 70
  470.  
  471.    CompuServe: J. Bergemann: 100270,356
  472.  
  473.  
  474.    The address of media tools will change around the middle of 1995.
  475.  
  476.  
  477.    The registration fee including shipping is $40.
  478.  
  479.  
  480.                                ─────── ∙ ───────
  481.           
  482.                               End of FRACTANI.DOC
  483.  
  484.                             Kai Mysliwiec 03/25-1994
  485.  
  486.                                ─────── ∙ ───────
  487.  
  488.